<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" >

  <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/turbolinks/5.2.0/turbolinks.js" integrity="sha256-iM4Yzi/zLj/IshPWMC1IluRxTtRjMqjPGd97TZ9yYpU=" crossorigin="anonymous"></script>
  <link href="https://fonts.googleapis.com/css?family=Roboto+Mono" rel="stylesheet">
  <link href="https://fonts.googleapis.com/css?family=Cousine|Inconsolata" rel="stylesheet">
  <link rel="shortcut icon" type="image/png" href="/favicon.png">

  <link rel="stylesheet" href="/css/style.css">
  <link rel="stylesheet" href="/css/css/fontawesome-all.min.css">
  <link rel="stylesheet" href="/css/css/work-sans-v7.css">
  <script src="/js/main.js"></script>

  <!-- Begin Jekyll SEO tag v2.6.1 -->
<title>Services | Hive Developer</title>
<meta name="generator" content="Jekyll v4.0.0" />
<meta property="og:title" content="Services" />
<meta property="og:locale" content="en_US" />
<meta name="description" content="Hive Developer Documentation." />
<meta property="og:description" content="Hive Developer Documentation." />
<link rel="canonical" href="https://developers.hive.io/services/" />
<meta property="og:url" content="https://developers.hive.io/services/" />
<meta property="og:site_name" content="Hive Developer" />
<script type="application/ld+json">
{"description":"Hive Developer Documentation.","@type":"WebPage","url":"https://developers.hive.io/services/","headline":"Services","@context":"https://schema.org"}</script>
<!-- End Jekyll SEO tag -->


  
</head>
<body>
<header>
  <h1>
    <button type="button" class="open-nav" id="open-nav"></button>
    <a href="/"  class="logo-link"><img src="/images/logotype_black.svg" height="40" alt="Hive Developer logo"></a>
  </h1>

  
  <form action="/search/" method="get">
    <input type="text" name="q" id="search-input" placeholder="Search">
    <input type="submit" value="Search" style="display: none;">
  </form>
  

  <div id="sidebar" class="sidebar">
	
	
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/">
		<h6 class="ctrl-nav-section title">Introduction</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/#introduction-welcome">Welcome to Hive</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/quickstart/">
		<h6 class="ctrl-nav-section title">Quickstart</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/quickstart/#quickstart-choose-library">Choose Library</a></li>
						
					
						
						<li><a href="/quickstart/#quickstart-hive-full-nodes">Hive Nodes</a></li>
						
					
						
						<li><a href="/quickstart/#quickstart-testnet">Hive Testnet</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/tutorials/">
		<h6 class="ctrl-nav-section title">Tutorials</h6>
		<ul class="cont-nav-section content">
			
				
					
						<li><a href="/tutorials/#tutorials-javascript">Javascript</a></li>
					
				
					
						<li><a href="/tutorials/#tutorials-python">Python</a></li>
					
				
					
						<li><a href="/tutorials/#tutorials-ruby">Ruby</a></li>
					
				
					
						<li><a href="/tutorials/#tutorials-recipes">Recipes</a></li>
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/services/">
		<h6 class="ctrl-nav-section title">Services</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/services/#services-hive-blog">hive.blog</a></li>
						
					
						
						<li><a href="/services/#services-hivesigner">HiveSigner</a></li>
						
					
						
						<li><a href="/services/#services-jussi">Jussi</a></li>
						
					
						
						<li><a href="/services/#services-imagehoster">ImageHoster</a></li>
						
					
						
						<li><a href="/services/#services-dhf">DHF</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/apidefinitions/">
		<h6 class="ctrl-nav-section title">Appbase API</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/apidefinitions/#apidefinitions-condenser-api">Condenser Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-bridge">Bridge</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-account-by-key-api">Account By Key Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-account-history-api">Account History Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-block-api">Block Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-database-api">Database Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-debug-node-api">Debug Node Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-follow-api">Follow Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-jsonrpc">Jsonrpc</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-market-history-api">Market History Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-network-broadcast-api">Network Broadcast Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-rc-api">Rc Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-reputation-api">Reputation Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-rewards-api">Rewards Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-tags-api">Tags Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-transaction-status-api">Transaction Status Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-witness-api">Witness Api</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-broadcast-ops">Broadcast Ops</a></li>
						
					
						
						<li><a href="/apidefinitions/#apidefinitions-broadcast-ops-communities">Broadcast Ops Communities</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/resources/">
		<h6 class="ctrl-nav-section title">Resources</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/resources/#resources-overview">Overview</a></li>
						
					
						
						<li><a href="/resources/#resources-client-libs">Client Libraries</a></li>
						
					
						
						<li><a href="/resources/#resources-bluepaper">Bluepaper</a></li>
						
					
						
						<li><a href="/resources/#resources-whitepaper">Whitepaper</a></li>
						
					
						
						<li><a href="/resources/#resources-tools">Tools</a></li>
						
					
						
						<li><a href="/resources/#resources-hivesigner-libs">Hivesigner Libs</a></li>
						
					
						
						<li><a href="/resources/#resources-hive-keychain">Hive Keychain</a></li>
						
					
						
						<li><a href="/resources/#resources-developeradvocate">Community & Help</a></li>
						
					
				
			
		</ul>
	</section>
	
		
    <section class="pnl-main-nav-section main-nav-section" url="/glossary/">
		<h6 class="ctrl-nav-section title">Glossary</h6>
		<ul class="cont-nav-section content">
			
				
					
					
						
						<li><a href="/glossary/#glossary-chain-basics">Chain Basics</a></li>
						
					
						
					
						
						<li><a href="/glossary/#glossary-governance">Governance</a></li>
						
					
						
						<li><a href="/glossary/#glossary-transactions">Transactions</a></li>
						
					
						
						<li><a href="/glossary/#glossary-api">API</a></li>
						
					
						
						<li><a href="/glossary/#glossary-market">Market</a></li>
						
					
				
			
		</ul>
	</section>
	
</div>



  <link href="https://fonts.googleapis.com/css?family=Nunito" rel="stylesheet">
</header>
<div class="main" id="top">
  <div class="hero">
    <h1 class="hero__h1">Hive Developer Portal  - Services</h1>
    <img class="hero__img" src="/images/honey-comb-92.png" style="position: relative; top: 10px;" />
  </div>
  

	
	
		<section id="services-hive-blog" class="row services-hive-blog">
			<h3>
				<a id="services-hive-blog">
					hive.blog
					
				</a>
			</h3>
			

			<h4 id="hiveblog-endpoints">Hive.blog endpoints</h4>

<p>Hive.blog offers a few endpoints for getting common data. User profile and post JSON data is very convenient and simple by appending .json
to your request.</p>

<p>Getting a particular user profile JSON:</p>

<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://hive.blog/@curie.json
</code></pre></div></div>

<p>User object</p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
   </span><span class="nl">"user"</span><span class="p">:{</span><span class="w">
      </span><span class="nl">"id"</span><span class="p">:</span><span class="mi">81544</span><span class="p">,</span><span class="w">
      </span><span class="nl">"name"</span><span class="p">:</span><span class="s2">"curie"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"owner"</span><span class="p">:{</span><span class="w">
         </span><span class="nl">"weight_threshold"</span><span class="p">:</span><span class="mi">1</span><span class="p">,</span><span class="w">
         </span><span class="nl">"account_auths"</span><span class="p">:[],</span><span class="w">
         </span><span class="nl">"key_auths"</span><span class="p">:[[</span><span class="s2">"STM69WGR1yhUdKrnzwQLDPnXrW9kaAERwHze8Uvtw2ecgRqCEjWxT"</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">]]</span><span class="w">
      </span><span class="p">},</span><span class="w">
      </span><span class="nl">"active"</span><span class="p">:{</span><span class="w">
         </span><span class="nl">"weight_threshold"</span><span class="p">:</span><span class="mi">1</span><span class="p">,</span><span class="w">
         </span><span class="nl">"account_auths"</span><span class="p">:[],</span><span class="w">
         </span><span class="nl">"key_auths"</span><span class="p">:[[</span><span class="s2">"STM5GAbbS84ViMEouJL3LKcM8VZzPejn68AfPaYaLZZDdmy98kwU5"</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">]]</span><span class="w">
      </span><span class="p">},</span><span class="w">
      </span><span class="nl">"posting"</span><span class="p">:{</span><span class="w">
         </span><span class="nl">"weight_threshold"</span><span class="p">:</span><span class="mi">1</span><span class="p">,</span><span class="w">
         </span><span class="nl">"account_auths"</span><span class="p">:[[</span><span class="s2">"steemauto"</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">]],</span><span class="w">
         </span><span class="nl">"key_auths"</span><span class="p">:[[</span><span class="s2">"STM5cmuKw6EPkZWeVNXcZorKtattZTX5wSopcRb4xNe6VhRKjETgv"</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">]]</span><span class="w">
      </span><span class="p">},</span><span class="w">
      </span><span class="nl">"memo_key"</span><span class="p">:</span><span class="s2">"STM7ZBi61xYz1b9STE1PHcAraPXJbvafzge3AcPjcfeq4XkKtM2At"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"json_metadata"</span><span class="p">:{</span><span class="w">
         </span><span class="nl">"profile"</span><span class="p">:{</span><span class="w">
            </span><span class="nl">"profile_image"</span><span class="p">:</span><span class="s2">"https://i.imgur.com/Mjewc66.jpg"</span><span class="p">,</span><span class="w">
            </span><span class="nl">"name"</span><span class="p">:</span><span class="s2">"Curie"</span><span class="p">,</span><span class="w">
            </span><span class="nl">"about"</span><span class="p">:</span><span class="s2">"Discovering exceptional content. "</span><span class="p">,</span><span class="w">
            </span><span class="nl">"location"</span><span class="p">:</span><span class="s2">"Worldwide"</span><span class="p">,</span><span class="w">
            </span><span class="nl">"website"</span><span class="p">:</span><span class="s2">"http://curiesteem.com"</span><span class="w">
         </span><span class="p">}</span><span class="w">
      </span><span class="p">},</span><span class="w">
      </span><span class="nl">"proxy"</span><span class="p">:</span><span class="s2">""</span><span class="p">,</span><span class="w">
      </span><span class="nl">"last_owner_update"</span><span class="p">:</span><span class="s2">"1970-01-01T00:00:00"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"last_account_update"</span><span class="p">:</span><span class="s2">"2018-02-28T14:21:24"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"created"</span><span class="p">:</span><span class="s2">"2016-09-02T10:44:24"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"mined"</span><span class="p">:</span><span class="kc">false</span><span class="p">,</span><span class="w">
      </span><span class="nl">"recovery_account"</span><span class="p">:</span><span class="s2">"anonsteem"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"last_account_recovery"</span><span class="p">:</span><span class="s2">"1970-01-01T00:00:00"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"reset_account"</span><span class="p">:</span><span class="s2">"null"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"comment_count"</span><span class="p">:</span><span class="mi">0</span><span class="p">,</span><span class="w">
      </span><span class="nl">"lifetime_vote_count"</span><span class="p">:</span><span class="mi">0</span><span class="p">,</span><span class="w">
      </span><span class="nl">"post_count"</span><span class="p">:</span><span class="mi">1042</span><span class="p">,</span><span class="w">
      </span><span class="nl">"can_vote"</span><span class="p">:</span><span class="kc">true</span><span class="p">,</span><span class="w">
      </span><span class="nl">"voting_power"</span><span class="p">:</span><span class="mi">8927</span><span class="p">,</span><span class="w">
      </span><span class="nl">"last_vote_time"</span><span class="p">:</span><span class="s2">"2018-06-21T19:42:33"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"balance"</span><span class="p">:</span><span class="s2">"24.519 HIVE"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"savings_balance"</span><span class="p">:</span><span class="s2">"0.000 HIVE"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"sbd_balance"</span><span class="p">:</span><span class="s2">"36.736 HBD"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"sbd_seconds"</span><span class="p">:</span><span class="s2">"11732264931"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"sbd_seconds_last_update"</span><span class="p">:</span><span class="s2">"2018-06-21T19:35:00"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"sbd_last_interest_payment"</span><span class="p">:</span><span class="s2">"2018-06-15T14:05:03"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"savings_sbd_balance"</span><span class="p">:</span><span class="s2">"0.000 HBD"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"savings_sbd_seconds"</span><span class="p">:</span><span class="s2">"0"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"savings_sbd_seconds_last_update"</span><span class="p">:</span><span class="s2">"1970-01-01T00:00:00"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"savings_sbd_last_interest_payment"</span><span class="p">:</span><span class="s2">"1970-01-01T00:00:00"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"savings_withdraw_requests"</span><span class="p">:</span><span class="mi">0</span><span class="p">,</span><span class="w">
      </span><span class="nl">"reward_sbd_balance"</span><span class="p">:</span><span class="s2">"0.000 HBD"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"reward_steem_balance"</span><span class="p">:</span><span class="s2">"0.000 HIVE"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"reward_vesting_balance"</span><span class="p">:</span><span class="s2">"481.354811 VESTS"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"reward_vesting_steem"</span><span class="p">:</span><span class="s2">"0.237 HIVE"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"vesting_shares"</span><span class="p">:</span><span class="s2">"128367480.795804 VESTS"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"delegated_vesting_shares"</span><span class="p">:</span><span class="s2">"0.000000 VESTS"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"received_vesting_shares"</span><span class="p">:</span><span class="s2">"17069919.621493 VESTS"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"vesting_withdraw_rate"</span><span class="p">:</span><span class="s2">"9672265.370398 VESTS"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"next_vesting_withdrawal"</span><span class="p">:</span><span class="s2">"2018-06-24T14:01:51"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"withdrawn"</span><span class="p">:</span><span class="mi">0</span><span class="p">,</span><span class="w">
      </span><span class="nl">"to_withdraw"</span><span class="p">:</span><span class="s2">"125739449815180"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"withdraw_routes"</span><span class="p">:</span><span class="mi">0</span><span class="p">,</span><span class="w">
      </span><span class="nl">"curation_rewards"</span><span class="p">:</span><span class="mi">79730650</span><span class="p">,</span><span class="w">
      </span><span class="nl">"posting_rewards"</span><span class="p">:</span><span class="mi">168964559</span><span class="p">,</span><span class="w">
      </span><span class="nl">"proxied_vsf_votes"</span><span class="p">:[</span><span class="s2">"1753316906111"</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">],</span><span class="w">
      </span><span class="nl">"witnesses_voted_for"</span><span class="p">:</span><span class="mi">1</span><span class="p">,</span><span class="w">
      </span><span class="nl">"last_post"</span><span class="p">:</span><span class="s2">"2018-06-21T18:06:57"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"last_root_post"</span><span class="p">:</span><span class="s2">"2018-06-19T13:16:15"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"average_bandwidth"</span><span class="p">:</span><span class="s2">"540385456623"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"lifetime_bandwidth"</span><span class="p">:</span><span class="s2">"33717478000000"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"last_bandwidth_update"</span><span class="p">:</span><span class="s2">"2018-06-21T19:42:33"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"average_market_bandwidth"</span><span class="p">:</span><span class="s2">"83841450748"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"lifetime_market_bandwidth"</span><span class="p">:</span><span class="s2">"8042800000000"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"last_market_bandwidth_update"</span><span class="p">:</span><span class="s2">"2018-06-19T04:21:42"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"vesting_balance"</span><span class="p">:</span><span class="s2">"0.000 HIVE"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"reputation"</span><span class="p">:</span><span class="s2">"418378051905700"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"transfer_history"</span><span class="p">:[],</span><span class="w">
      </span><span class="nl">"market_history"</span><span class="p">:[],</span><span class="w">
      </span><span class="nl">"post_history"</span><span class="p">:[],</span><span class="w">
      </span><span class="nl">"vote_history"</span><span class="p">:[],</span><span class="w">
      </span><span class="nl">"other_history"</span><span class="p">:[],</span><span class="w">
      </span><span class="nl">"witness_votes"</span><span class="p">:[</span><span class="s2">"curie"</span><span class="p">],</span><span class="w">
      </span><span class="nl">"tags_usage"</span><span class="p">:[],</span><span class="w">
      </span><span class="nl">"guest_bloggers"</span><span class="p">:[]</span><span class="w">
   </span><span class="p">},</span><span class="w">
   </span><span class="nl">"status"</span><span class="p">:</span><span class="s2">"200"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<p>Getting a particular post JSON:</p>

<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://hive.blog/curation/@curie/the-daily-curie-12-13-feb-2017.json
</code></pre></div></div>

<p>Post object</p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
  </span><span class="nl">"post"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
    </span><span class="nl">"id"</span><span class="p">:</span><span class="w"> </span><span class="mi">1965592</span><span class="p">,</span><span class="w">
    </span><span class="nl">"author"</span><span class="p">:</span><span class="w"> </span><span class="s2">"curie"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"permlink"</span><span class="p">:</span><span class="w"> </span><span class="s2">"the-daily-curie-12-13-feb-2017"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"category"</span><span class="p">:</span><span class="w"> </span><span class="s2">"curation"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"parent_author"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span><span class="w">
    </span><span class="nl">"parent_permlink"</span><span class="p">:</span><span class="w"> </span><span class="s2">"curation"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"title"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Daily Curie (12-13 Feb 2017)"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"body"</span><span class="p">:</span><span class="w"> </span><span class="s2">"..."</span><span class="p">,</span><span class="w">
    </span><span class="nl">"json_metadata"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
      </span><span class="nl">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"curation"</span><span class="p">,</span><span class="w"> </span><span class="s2">"curie"</span><span class="p">],</span><span class="w">
      </span><span class="nl">"users"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
        </span><span class="s2">"nextgencrypto"</span><span class="p">,</span><span class="w">
        </span><span class="s2">"berniesanders"</span><span class="p">,</span><span class="w">
        </span><span class="s2">"val"</span><span class="p">,</span><span class="w">
        </span><span class="s2">"silversteem"</span><span class="p">,</span><span class="w">
        </span><span class="s2">"clayop"</span><span class="p">,</span><span class="w">
        </span><span class="s2">"hendrikdegrote"</span><span class="p">,</span><span class="w">
        </span><span class="s2">"proskynneo"</span><span class="p">,</span><span class="w">
        </span><span class="s2">"kushed"</span><span class="p">,</span><span class="w">
        </span><span class="s2">"curie"</span><span class="w">
      </span><span class="p">],</span><span class="w">
      </span><span class="nl">"image"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
      </span><span class="nl">"links"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
      </span><span class="nl">"app"</span><span class="p">:</span><span class="w"> </span><span class="s2">"steemit/0.1"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"format"</span><span class="p">:</span><span class="w"> </span><span class="s2">"markdown"</span><span class="w">
    </span><span class="p">},</span><span class="w">
    </span><span class="nl">"last_update"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2017-02-13T18:00:51"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2017-02-13T18:00:51"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"active"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2017-02-14T16:19:24"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"last_payout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2017-03-16T19:08:27"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"depth"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
    </span><span class="nl">"children"</span><span class="p">:</span><span class="w"> </span><span class="mi">9</span><span class="p">,</span><span class="w">
    </span><span class="nl">"net_rshares"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
    </span><span class="nl">"abs_rshares"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
    </span><span class="nl">"vote_rshares"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
    </span><span class="nl">"children_abs_rshares"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
    </span><span class="nl">"cashout_time"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1969-12-31T23:59:59"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"max_cashout_time"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1969-12-31T23:59:59"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"total_vote_weight"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
    </span><span class="nl">"reward_weight"</span><span class="p">:</span><span class="w"> </span><span class="mi">10000</span><span class="p">,</span><span class="w">
    </span><span class="nl">"total_payout_value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"23.678 HBD"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"curator_payout_value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1.196 HBD"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"author_rewards"</span><span class="p">:</span><span class="w"> </span><span class="mi">167726</span><span class="p">,</span><span class="w">
    </span><span class="nl">"net_votes"</span><span class="p">:</span><span class="w"> </span><span class="mi">465</span><span class="p">,</span><span class="w">
    </span><span class="nl">"root_author"</span><span class="p">:</span><span class="w"> </span><span class="s2">"curie"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"root_permlink"</span><span class="p">:</span><span class="w"> </span><span class="s2">"the-daily-curie-12-13-feb-2017"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"max_accepted_payout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1000000.000 HBD"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"percent_steem_dollars"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
    </span><span class="nl">"allow_replies"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
    </span><span class="nl">"allow_votes"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
    </span><span class="nl">"allow_curation_rewards"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
    </span><span class="nl">"beneficiaries"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
    </span><span class="nl">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/curation/@curie/the-daily-curie-12-13-feb-2017"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"root_title"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Daily Curie (12-13 Feb 2017)"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"pending_payout_value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0.000 HBD"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"total_pending_payout_value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0.000 HBD"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"active_votes"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
    </span><span class="nl">"replies"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
    </span><span class="nl">"author_reputation"</span><span class="p">:</span><span class="w"> </span><span class="s2">"545477526857484"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"promoted"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0.000 HBD"</span><span class="p">,</span><span class="w">
    </span><span class="nl">"body_length"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
    </span><span class="nl">"reblogged_by"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
  </span><span class="p">},</span><span class="w">
  </span><span class="nl">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"200"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

		</section>
	
		<section id="services-hivesigner" class="row services-hivesigner">
			<h3>
				<a id="services-hivesigner">
					HiveSigner
					
				</a>
			</h3>
			

			<p><strong>What is HiveSigner?</strong></p>

<p>The goal of HiveSigner is to provide a safe way of connecting to the blockchain via 3rd party apps without compromising the security of your private keys and passwords. It’s a simple identity layer built on top of the blockchain allowing users safe access and developers the freedom of not having to handle the authentication system, i.e. managing users’ private keys and encryption. This means that devs won’t have to open-source their projects in order to gain user trust. When connecting to apps in this manner, neither Hivesigner nor the authorized app store the private keys as the posting key is encrypted on your cookie.</p>

<p><strong>How HiveSigner is implemented</strong></p>

<p>HiveSigner works by granting an access token to the requesting app once the application has been approved.
A full tutorial on how to set up an application, request authorization and grant access can be found <a href="/tutorials-javascript/hivesigner.html">here</a>.</p>

<p><strong>Hive Authorisation and OAuth 2</strong></p>

<p>The OAuth protocol allows third party apps to grant limited access to an HTTP service, either on behalf of a resource owner or by allowing the app to obtain access on its own behalf. The authorization is provided without the private key or password of the user being shared with the third party.
Simplified, the process includes the following steps:</p>

<ol>
  <li>The user is presented with an authorization link that requests a token from the API</li>
  <li>The user has to log in to the service to verify their identity whereupon they will be prompted to authorize the application</li>
  <li>The user is redirected to the application redirect URI along with the access token</li>
</ol>

<p>Once the application has an access token, it may use the token to access the user’s account via the API, limited to the scope of access, until the token expires or is revoked.
A full breakdown of OAuth2 and how it applies to Hive and HiveSigner can be found <a href="https://github.com/ledgerconnect/hivesigner/wiki/OAuth-2#code-authorization-flow">here</a>.</p>

<p><strong>Useful Links</strong></p>

<ul>
  <li><a href="https://github.com/ledgerconnect/hivesigner">HiveSigner Repo</a></li>
  <li><a href="/resources/#community-hivesigner-libs">Community Resources</a></li>
</ul>

<p>For additional material you can refer to the original Hive <a href="https://hive.blog/hive/@good-karma/hivesigner-released-and-ready">blog</a> post by <a href="https://hive.blog/">@good-karma</a></p>

		</section>
	
		<section id="services-jussi" class="row services-jussi">
			<h3>
				<a id="services-jussi">
					Jussi
					
				</a>
			</h3>
			
				<p class="description">A reverse proxy that forwards json-rpc requests.</p>
			

			<p>Jussi is a custom-built caching layer for use with <code class="highlighter-rouge">steemd</code> and other various services (such as <a href="/services/#services-sbds">SBDS</a>).</p>

<p>The purpose of this document is to help developers and node operators set up their own jussi node within a docker container.</p>

<h3 id="intro">Intro</h3>

<p>Jussi is a reverse proxy that is situation between the API client and the <code class="highlighter-rouge">steemd</code> server.  It allows node operators to route an API call to nodes that are optimized for the particular call, as if they are all hosted from the same place.</p>

<h3 id="sections">Sections</h3>

<ul>
  <li><a href="#installation">Installation</a></li>
  <li><a href="#adding-upstreams">Adding Upstreams</a></li>
  <li><a href="#benefits-of-jussi">Benefits of jussi</a>
    <ul>
      <li><a href="#time-to-live">TTL</a></li>
      <li><a href="#multiple-routes">Multiple Routes</a></li>
      <li><a href="#retry">Retry</a></li>
      <li><a href="#json-rpc-batch">json-rpc batch</a></li>
    </ul>
  </li>
  <li><a href="#footnotes">Footnotes</a></li>
</ul>

<h3 id="installation">Installation<a style="float: right" href="#sections"><i class="fas fa-chevron-up fa-sm"></i></a></h3>

<h5 id="to-run-jussi-locally">To run <code class="highlighter-rouge">jussi</code> locally:</h5>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git clone https://github.com/steemit/jussi.git
<span class="nb">cd </span>jussi
docker build <span class="nt">-t</span><span class="o">=</span><span class="s2">"</span><span class="nv">$USER</span><span class="s2">/jussi:</span><span class="si">$(</span>git rev-parse <span class="nt">--abbrev-ref</span> HEAD<span class="si">)</span><span class="s2">"</span> <span class="nb">.</span>
docker run <span class="nt">-itp</span> 9000:8080 <span class="s2">"</span><span class="nv">$USER</span><span class="s2">/jussi:</span><span class="si">$(</span>git rev-parse <span class="nt">--abbrev-ref</span> HEAD<span class="si">)</span><span class="s2">"</span>
</code></pre></div></div>

<p><img src="/images/services-jussi/kitematic-example.png" width="100%" alt="Kitematic Example" />
<small><em>jussi in a docker container as seen from <a href="https://docs.docker.com/docker-for-mac/install/">Kitematic for macOS</a>.</em></small></p>

<h5 id="try-out-your-local-configuration">Try out your local configuration:</h5>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-s</span> <span class="nt">--data</span> <span class="s1">'{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[8675309], "id":1}'</span> http://localhost:9000
</code></pre></div></div>

<p>See: <a href="https://steemit.com/steemdev/@maitland/running-condenser-jussi-and-a-new-service-locally-adding-feature-flags-to-condenser">Running Condenser, Jussi and a new service locally + adding feature flags to Condenser</a></p>

<hr />

<h3 id="adding-upstreams">Adding Upstreams<a style="float: right" href="#sections"><i class="fas fa-chevron-up fa-sm"></i></a></h3>

<p>The default <code class="highlighter-rouge">DEV_config.json</code> is:</p>

<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
   </span><span class="nl">"limits"</span><span class="p">:{</span><span class="nl">"blacklist_accounts"</span><span class="p">:[</span><span class="s2">"non-steemit"</span><span class="p">]},</span><span class="w">
   </span><span class="nl">"upstreams"</span><span class="p">:[</span><span class="w">
      </span><span class="p">{</span><span class="w">
         </span><span class="nl">"name"</span><span class="p">:</span><span class="s2">"steemd"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"translate_to_appbase"</span><span class="p">:</span><span class="kc">false</span><span class="p">,</span><span class="w">
         </span><span class="nl">"urls"</span><span class="p">:[[</span><span class="s2">"steemd"</span><span class="p">,</span><span class="w"> </span><span class="s2">"https://steemd.steemitdev.com"</span><span class="p">]],</span><span class="w">
         </span><span class="nl">"ttls"</span><span class="p">:[</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd"</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.login_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">-1</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.network_broadcast_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">-1</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.follow_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.market_history_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_block"</span><span class="p">,</span><span class="w"> </span><span class="mi">-2</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_block_header"</span><span class="p">,</span><span class="w"> </span><span class="mi">-2</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_content"</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_state"</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_state.params=['/trending']"</span><span class="p">,</span><span class="w"> </span><span class="mi">30</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_state.params=['trending']"</span><span class="p">,</span><span class="w"> </span><span class="mi">30</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_state.params=['/hot']"</span><span class="p">,</span><span class="w"> </span><span class="mi">30</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_state.params=['/welcome']"</span><span class="p">,</span><span class="w"> </span><span class="mi">30</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_state.params=['/promoted']"</span><span class="p">,</span><span class="w"> </span><span class="mi">30</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_state.params=['/created']"</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.database_api.get_dynamic_global_properties"</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">]</span><span class="w">
         </span><span class="p">],</span><span class="w">
         </span><span class="nl">"timeouts"</span><span class="p">:[</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd"</span><span class="p">,</span><span class="w"> </span><span class="mi">5</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.network_broadcast_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">]</span><span class="w">
         </span><span class="p">],</span><span class="w">
         </span><span class="nl">"retries"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd"</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"steemd.network_broadcast_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">]</span><span class="w">
         </span><span class="p">]</span><span class="w">
      </span><span class="p">},</span><span class="w">
      </span><span class="p">{</span><span class="w">
         </span><span class="nl">"name"</span><span class="p">:</span><span class="s2">"appbase"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"urls"</span><span class="p">:[[</span><span class="s2">"appbase"</span><span class="p">,</span><span class="w"> </span><span class="s2">"https://steemd.steemitdev.com"</span><span class="p">]],</span><span class="w">
         </span><span class="nl">"ttls"</span><span class="p">:[</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase"</span><span class="p">,</span><span class="w"> </span><span class="mi">-2</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase.block_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">-2</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase.database_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">]</span><span class="w">
         </span><span class="p">],</span><span class="w">
         </span><span class="nl">"timeouts"</span><span class="p">:[</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase"</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase.chain_api.push_block"</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase.chain_api.push_transaction"</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase.network_broadcast_api"</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase.condenser_api.broadcast_block"</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase.condenser_api.broadcast_transaction"</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">],</span><span class="w">
            </span><span class="p">[</span><span class="s2">"appbase.condenser_api.broadcast_transaction_synchronous"</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">]</span><span class="w">
         </span><span class="p">]</span><span class="w">
      </span><span class="p">}</span><span class="w">
   </span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<p>Upstreams can be added to the <code class="highlighter-rouge">upstreams</code> array:</p>

<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
  </span><span class="nl">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"foo"</span><span class="p">,</span><span class="w">
  </span><span class="nl">"urls"</span><span class="p">:</span><span class="w"> </span><span class="p">[[</span><span class="s2">"foo"</span><span class="p">,</span><span class="w"> </span><span class="s2">"https://foo.host.name"</span><span class="p">]],</span><span class="w">
  </span><span class="nl">"ttls"</span><span class="p">:</span><span class="w"> </span><span class="p">[[</span><span class="s2">"foo"</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">]],</span><span class="w">
  </span><span class="nl">"timeouts"</span><span class="p">:</span><span class="w"> </span><span class="p">[[</span><span class="s2">"foo"</span><span class="p">,</span><span class="w"> </span><span class="mi">5</span><span class="p">]]</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<p>Once the above upstream is added to the local config and docker has been built, the following <code class="highlighter-rouge">curl</code> will work:</p>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-s</span> <span class="nt">--data</span> <span class="s1">'{"jsonrpc":"2.0", "method":"foo.bar", "params":["baz"], "id":1}'</span> http://localhost:9000
</code></pre></div></div>

<p><strong>Note:</strong> if you set <code class="highlighter-rouge">translate_to_appbase</code> as <code class="highlighter-rouge">true</code>, jussi will do the translation for you and that specific endpoint will work with libraries that don’t yet support appbase.</p>

<h3 id="benefits-of-jussi">Benefits of jussi<a style="float: right" href="#sections"><i class="fas fa-chevron-up fa-sm"></i></a></h3>

<h4 id="time-to-live">Time To Live<a style="float: right" href="#sections"><i class="fas fa-chevron-up fa-sm"></i></a></h4>

<p>Jussi can be configured with various <code class="highlighter-rouge">TTL</code> (Time To Live) schemes. A <code class="highlighter-rouge">TTL</code> is an integer value in seconds.  Integers equal to or less than <code class="highlighter-rouge">0</code> have special meaning.  A reasonable set of defaults would be:</p>

<table>
  <thead>
    <tr>
      <th>Upstream</th>
      <th>API</th>
      <th>Method</th>
      <th>Parameters</th>
      <th>TTL (seconds)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">login_api</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>-1</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">network_broadcast_api</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>-1</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">follow_api</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>10</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">market_history_api</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>1</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>3</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_block</code></td>
      <td><em>all</em></td>
      <td>-2</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_block_header</code></td>
      <td><em>all</em></td>
      <td>-2</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_content</code></td>
      <td><em>all</em></td>
      <td>1</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_state</code></td>
      <td><em>all</em></td>
      <td>1</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_state</code></td>
      <td><code class="highlighter-rouge">'/trending'</code></td>
      <td>30</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_state</code></td>
      <td><code class="highlighter-rouge">'trending'</code></td>
      <td>30</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_state</code></td>
      <td><code class="highlighter-rouge">'/hot'</code></td>
      <td>30</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_state</code></td>
      <td><code class="highlighter-rouge">'/welcome'</code></td>
      <td>30</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_state</code></td>
      <td><code class="highlighter-rouge">'/promoted'</code></td>
      <td>30</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_state</code></td>
      <td><code class="highlighter-rouge">'/created'</code></td>
      <td>10</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">steemd</code></td>
      <td><code class="highlighter-rouge">database_api</code></td>
      <td><code class="highlighter-rouge">get_dynamic_global_properties</code></td>
      <td><em>all</em></td>
      <td>1</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">overseer</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>5</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">conveyor</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>-1</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">sbds</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>3</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">hivemind</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>3</td>
    </tr>
    <tr>
      <td><code class="highlighter-rouge">yo</code></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td><em>all</em></td>
      <td>3</td>
    </tr>
  </tbody>
</table>

<p>In this case, requests for <code class="highlighter-rouge">login_api</code> and <code class="highlighter-rouge">network_broadcast_api</code> have a <code class="highlighter-rouge">TTL</code> of <code class="highlighter-rouge">-1</code>, which means requests with those namespaces are not cached, whereas <code class="highlighter-rouge">follow_api</code> request have a <code class="highlighter-rouge">TTL</code> of <code class="highlighter-rouge">10</code> seconds.</p>

<p>Some methods and parameters have their own <code class="highlighter-rouge">TTL</code> that overrides the general default, like <code class="highlighter-rouge">database_api.get_block</code>, which overrides <code class="highlighter-rouge">database_api.*</code>.</p>

<h5 id="time-to-live-special-meaning">Time to Live Special Meaning</h5>

<ul>
  <li><code class="highlighter-rouge">0</code> won’t expire</li>
  <li><code class="highlighter-rouge">-1</code> won’t be cached</li>
  <li><code class="highlighter-rouge">-2</code> will be cached without expiration only if it is <code class="highlighter-rouge">irreversible</code> in terms of blockchain consensus</li>
</ul>

<p>If you have a local copy of jussi (see: <a href="#installation">Installation</a>), you can change these defaults by modifying <code class="highlighter-rouge">DEV_config.json</code>.</p>

<h4 id="multiple-routes">Multiple Routes<a style="float: right" href="#sections"><i class="fas fa-chevron-up fa-sm"></i></a></h4>

<p>Each <code class="highlighter-rouge">urls</code> key can have multiple endpoints for each namespace.  For example:</p>

<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
  </span><span class="nl">"urls"</span><span class="p">:[</span><span class="w">
    </span><span class="p">[</span><span class="s2">"appbase"</span><span class="p">,</span><span class="w"> </span><span class="s2">"https://api.steemitdev.com"</span><span class="p">]</span><span class="w">
  </span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<p>… can also be expressed as:</p>

<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
  </span><span class="nl">"urls"</span><span class="p">:[</span><span class="w">
    </span><span class="p">[</span><span class="s2">"appbase"</span><span class="p">,</span><span class="s2">"https://api.steemitdev.com"</span><span class="p">],</span><span class="w">
    </span><span class="p">[</span><span class="s2">"appbase.condenser_api.get_account_history"</span><span class="p">,</span><span class="s2">"https://api-for-account-history.steemitdev.com"</span><span class="p">],</span><span class="w">
    </span><span class="p">[</span><span class="s2">"appbase.condenser_api.get_ops_in_block"</span><span class="p">,</span><span class="s2">"https://api-for-get-ops-in-block.steemitdev.com"</span><span class="p">]</span><span class="w">
  </span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<p>In these examples, the methods <code class="highlighter-rouge">get_account_history</code> and <code class="highlighter-rouge">get_ops_in_block</code> route to a dedicated API endpoint, while the rest of the <code class="highlighter-rouge">appbase</code> namespace routes to a common endpoint.</p>

<h4 id="retry">Retry<a style="float: right" href="#sections"><i class="fas fa-chevron-up fa-sm"></i></a></h4>

<p>Adding a <code class="highlighter-rouge">retries</code> element defines the number of retry attempts, where <code class="highlighter-rouge">0</code> (or absent) means no retry.  The maximum number of retries is <code class="highlighter-rouge">3</code>.</p>

<p>Note that retrying broadcast methods is not recommended, which is why the example explicitly sets <code class="highlighter-rouge">steemd.network_broadcast_api</code> to <code class="highlighter-rouge">0</code>.</p>

<h4 id="json-rpc-batch">json-rpc batch<a style="float: right" href="#sections"><i class="fas fa-chevron-up fa-sm"></i></a></h4>

<p>Normally, a request is made with a JSON Object (<code class="highlighter-rouge">{}</code>).  But jussi also supports batch requests, which is constructed with a JSON Array of Objects (<code class="highlighter-rouge">[{}]</code>).</p>

<p>For example, this would be a typical, non-batched JSON Object request that asks for a single block:</p>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-s</span> <span class="nt">--data</span> <span class="s1">'{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[1], "id":1}'</span> https://api.steemit.com
</code></pre></div></div>

<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
   </span><span class="nl">"id"</span><span class="p">:</span><span class="mi">1</span><span class="p">,</span><span class="w">
   </span><span class="nl">"jsonrpc"</span><span class="p">:</span><span class="s2">"2.0"</span><span class="p">,</span><span class="w">
   </span><span class="nl">"result"</span><span class="p">:{</span><span class="w">
      </span><span class="nl">"previous"</span><span class="p">:</span><span class="s2">"0000000000000000000000000000000000000000"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"timestamp"</span><span class="p">:</span><span class="s2">"2016-03-24T16:05:00"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"witness"</span><span class="p">:</span><span class="s2">"initminer"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"transaction_merkle_root"</span><span class="p">:</span><span class="s2">"0000000000000000000000000000000000000000"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"extensions"</span><span class="p">:[</span><span class="w">

      </span><span class="p">],</span><span class="w">
      </span><span class="nl">"witness_signature"</span><span class="p">:</span><span class="s2">"204f8ad56a8f5cf722a02b035a61b500aa59b9519b2c33c77a80c0a714680a5a5a7a340d909d19996613c5e4ae92146b9add8a7a663eef37d837ef881477313043"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"transactions"</span><span class="p">:[</span><span class="w">

      </span><span class="p">],</span><span class="w">
      </span><span class="nl">"block_id"</span><span class="p">:</span><span class="s2">"0000000109833ce528d5bbfb3f6225b39ee10086"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"signing_key"</span><span class="p">:</span><span class="s2">"STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"transaction_ids"</span><span class="p">:[</span><span class="w">

      </span><span class="p">]</span><span class="w">
   </span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<p>To request more than one block using the batch construct, wrap each call in a JSON Array, that asks for two blocks in one request:</p>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-s</span> <span class="nt">--data</span> <span class="s1">'[{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[1], "id":1},{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[2], "id":2}]'</span> https://api.steemit.com
</code></pre></div></div>

<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">[</span><span class="w">
   </span><span class="p">{</span><span class="w">
      </span><span class="nl">"id"</span><span class="p">:</span><span class="mi">1</span><span class="p">,</span><span class="w">
      </span><span class="nl">"jsonrpc"</span><span class="p">:</span><span class="s2">"2.0"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"result"</span><span class="p">:{</span><span class="w">
         </span><span class="nl">"previous"</span><span class="p">:</span><span class="s2">"0000000000000000000000000000000000000000"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"timestamp"</span><span class="p">:</span><span class="s2">"2016-03-24T16:05:00"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"witness"</span><span class="p">:</span><span class="s2">"initminer"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"transaction_merkle_root"</span><span class="p">:</span><span class="s2">"0000000000000000000000000000000000000000"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"extensions"</span><span class="p">:[</span><span class="w">

         </span><span class="p">],</span><span class="w">
         </span><span class="nl">"witness_signature"</span><span class="p">:</span><span class="s2">"204f8ad56a8f5cf722a02b035a61b500aa59b9519b2c33c77a80c0a714680a5a5a7a340d909d19996613c5e4ae92146b9add8a7a663eef37d837ef881477313043"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"transactions"</span><span class="p">:[</span><span class="w">

         </span><span class="p">],</span><span class="w">
         </span><span class="nl">"block_id"</span><span class="p">:</span><span class="s2">"0000000109833ce528d5bbfb3f6225b39ee10086"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"signing_key"</span><span class="p">:</span><span class="s2">"STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"transaction_ids"</span><span class="p">:[</span><span class="w">

         </span><span class="p">]</span><span class="w">
      </span><span class="p">}</span><span class="w">
   </span><span class="p">},</span><span class="w">
   </span><span class="p">{</span><span class="w">
      </span><span class="nl">"id"</span><span class="p">:</span><span class="mi">2</span><span class="p">,</span><span class="w">
      </span><span class="nl">"jsonrpc"</span><span class="p">:</span><span class="s2">"2.0"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"result"</span><span class="p">:{</span><span class="w">
         </span><span class="nl">"previous"</span><span class="p">:</span><span class="s2">"0000000109833ce528d5bbfb3f6225b39ee10086"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"timestamp"</span><span class="p">:</span><span class="s2">"2016-03-24T16:05:36"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"witness"</span><span class="p">:</span><span class="s2">"initminer"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"transaction_merkle_root"</span><span class="p">:</span><span class="s2">"0000000000000000000000000000000000000000"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"extensions"</span><span class="p">:[</span><span class="w">

         </span><span class="p">],</span><span class="w">
         </span><span class="nl">"witness_signature"</span><span class="p">:</span><span class="s2">"1f3e85ab301a600f391f11e859240f090a9404f8ebf0bf98df58eb17f455156e2d16e1dcfc621acb3a7acbedc86b6d2560fdd87ce5709e80fa333a2bbb92966df3"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"transactions"</span><span class="p">:[</span><span class="w">

         </span><span class="p">],</span><span class="w">
         </span><span class="nl">"block_id"</span><span class="p">:</span><span class="s2">"00000002ed04e3c3def0238f693931ee7eebbdf1"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"signing_key"</span><span class="p">:</span><span class="s2">"STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"transaction_ids"</span><span class="p">:[</span><span class="w">

         </span><span class="p">]</span><span class="w">
      </span><span class="p">}</span><span class="w">
   </span><span class="p">}</span><span class="w">
</span><span class="p">]</span><span class="w">
</span></code></pre></div></div>

<p>Error responses are returned in the JSON Array response as well.  Notice the <code class="highlighter-rouge">"WRONG"</code> parameter in the second element.  The first block is returned as expected, the second one generates an error.</p>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-s</span> <span class="nt">--data</span> <span class="s1">'[{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[1], "id":1},{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":["WRONG"], "id":2}]'</span> https://api.steemit.com
</code></pre></div></div>

<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">[</span><span class="w">
   </span><span class="p">{</span><span class="w">
      </span><span class="nl">"jsonrpc"</span><span class="p">:</span><span class="s2">"2.0"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"result"</span><span class="p">:{</span><span class="w">
         </span><span class="nl">"previous"</span><span class="p">:</span><span class="s2">"0000000000000000000000000000000000000000"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"timestamp"</span><span class="p">:</span><span class="s2">"2016-03-24T16:05:00"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"witness"</span><span class="p">:</span><span class="s2">"initminer"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"transaction_merkle_root"</span><span class="p">:</span><span class="s2">"0000000000000000000000000000000000000000"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"extensions"</span><span class="p">:[</span><span class="w">

         </span><span class="p">],</span><span class="w">
         </span><span class="nl">"witness_signature"</span><span class="p">:</span><span class="s2">"204f8ad56a8f5cf722a02b035a61b500aa59b9519b2c33c77a80c0a714680a5a5a7a340d909d19996613c5e4ae92146b9add8a7a663eef37d837ef881477313043"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"transactions"</span><span class="p">:[</span><span class="w">

         </span><span class="p">],</span><span class="w">
         </span><span class="nl">"block_id"</span><span class="p">:</span><span class="s2">"0000000109833ce528d5bbfb3f6225b39ee10086"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"signing_key"</span><span class="p">:</span><span class="s2">"STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"transaction_ids"</span><span class="p">:[</span><span class="w">

         </span><span class="p">]</span><span class="w">
      </span><span class="p">},</span><span class="w">
      </span><span class="nl">"id"</span><span class="p">:</span><span class="mi">1</span><span class="w">
   </span><span class="p">},</span><span class="w">
   </span><span class="p">{</span><span class="w">
      </span><span class="nl">"jsonrpc"</span><span class="p">:</span><span class="s2">"2.0"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"error"</span><span class="p">:{</span><span class="w">
         </span><span class="nl">"code"</span><span class="p">:</span><span class="mi">-32000</span><span class="p">,</span><span class="w">
         </span><span class="nl">"message"</span><span class="p">:</span><span class="s2">"Parse Error:Couldn't parse uint64_t"</span><span class="p">,</span><span class="w">
         </span><span class="nl">"data"</span><span class="p">:{</span><span class="w">
            </span><span class="nl">"code"</span><span class="p">:</span><span class="mi">4</span><span class="p">,</span><span class="w">
            </span><span class="nl">"name"</span><span class="p">:</span><span class="s2">"parse_error_exception"</span><span class="p">,</span><span class="w">
            </span><span class="nl">"message"</span><span class="p">:</span><span class="s2">"Parse Error"</span><span class="p">,</span><span class="w">
            </span><span class="nl">"stack"</span><span class="p">:[</span><span class="w">
               </span><span class="p">{</span><span class="w">
                  </span><span class="nl">"context"</span><span class="p">:{</span><span class="w">
                     </span><span class="nl">"level"</span><span class="p">:</span><span class="s2">"error"</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"file"</span><span class="p">:</span><span class="s2">"string.cpp"</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"line"</span><span class="p">:</span><span class="mi">113</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"method"</span><span class="p">:</span><span class="s2">"to_uint64"</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"hostname"</span><span class="p">:</span><span class="s2">""</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"timestamp"</span><span class="p">:</span><span class="s2">"2018-05-21T18:02:41"</span><span class="w">
                  </span><span class="p">},</span><span class="w">
                  </span><span class="nl">"format"</span><span class="p">:</span><span class="s2">"Couldn't parse uint64_t"</span><span class="p">,</span><span class="w">
                  </span><span class="nl">"data"</span><span class="p">:{</span><span class="w">

                  </span><span class="p">}</span><span class="w">
               </span><span class="p">},</span><span class="w">
               </span><span class="p">{</span><span class="w">
                  </span><span class="nl">"context"</span><span class="p">:{</span><span class="w">
                     </span><span class="nl">"level"</span><span class="p">:</span><span class="s2">"warn"</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"file"</span><span class="p">:</span><span class="s2">"string.cpp"</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"line"</span><span class="p">:</span><span class="mi">116</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"method"</span><span class="p">:</span><span class="s2">"to_uint64"</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"hostname"</span><span class="p">:</span><span class="s2">""</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"timestamp"</span><span class="p">:</span><span class="s2">"2018-05-21T18:02:41"</span><span class="w">
                  </span><span class="p">},</span><span class="w">
                  </span><span class="nl">"format"</span><span class="p">:</span><span class="s2">""</span><span class="p">,</span><span class="w">
                  </span><span class="nl">"data"</span><span class="p">:{</span><span class="w">
                     </span><span class="nl">"i"</span><span class="p">:</span><span class="s2">"WRONG"</span><span class="w">
                  </span><span class="p">}</span><span class="w">
               </span><span class="p">},</span><span class="w">
               </span><span class="p">{</span><span class="w">
                  </span><span class="nl">"context"</span><span class="p">:{</span><span class="w">
                     </span><span class="nl">"level"</span><span class="p">:</span><span class="s2">"warn"</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"file"</span><span class="p">:</span><span class="s2">"variant.cpp"</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"line"</span><span class="p">:</span><span class="mi">405</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"method"</span><span class="p">:</span><span class="s2">"as_uint64"</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"hostname"</span><span class="p">:</span><span class="s2">""</span><span class="p">,</span><span class="w">
                     </span><span class="nl">"timestamp"</span><span class="p">:</span><span class="s2">"2018-05-21T18:02:41"</span><span class="w">
                  </span><span class="p">},</span><span class="w">
                  </span><span class="nl">"format"</span><span class="p">:</span><span class="s2">""</span><span class="p">,</span><span class="w">
                  </span><span class="nl">"data"</span><span class="p">:{</span><span class="w">
                     </span><span class="nl">"*this"</span><span class="p">:</span><span class="s2">"WRONG"</span><span class="w">
                  </span><span class="p">}</span><span class="w">
               </span><span class="p">}</span><span class="w">
            </span><span class="p">]</span><span class="w">
         </span><span class="p">}</span><span class="w">
      </span><span class="p">},</span><span class="w">
      </span><span class="nl">"id"</span><span class="p">:</span><span class="mi">2</span><span class="w">
   </span><span class="p">}</span><span class="w">
</span><span class="p">]</span><span class="w">
</span></code></pre></div></div>

<h3 id="footnotes">Footnotes<a style="float: right" href="#sections"><i class="fas fa-chevron-up fa-sm"></i></a></h3>

<ul>
  <li>Batch requests are limited to a maximum of 50 request elements.
    <ul>
      <li><em>Also see: <a href="http://www.jsonrpc.org/specification#batch">json-rpc batch specification</a></em></li>
    </ul>
  </li>
  <li>Repository: <a href="https://github.com/steemit/jussi">github.com/steemit/jussi</a></li>
</ul>

<hr />

<p><em>Latin</em></p>

<blockquote>
  <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jussi

noun

declension: 2nd declension
gender: neuter

Definitions:
  1. order, command, decree, ordinance, law
</code></pre></div>  </div>
</blockquote>

		</section>
	
		<section id="services-imagehoster" class="row services-imagehoster">
			<h3>
				<a id="services-imagehoster">
					ImageHoster
					
				</a>
			</h3>
			

			<h1 id="definition">Definition</h1>

<p>Imagehoster is a Hive-powered image hosting and proxying service. Any image uploaded to, or proxied through, your Imagehoster has a copy stored within it. This means that the image continues to be available even if 3rd party sites go down or change their URLs. For as long as your instance of imagehoster is running the image will be available, anytime you need it.</p>

<p>The purpose of this tool is to provide a way to host and proxy images used by <a href="https://gitlab.syncad.com/hive/condenser#condenser">condenser</a> to help maintain the privacy of the authors and general users accessing the images.</p>

<p>Using ImageHoster will help limit access to IP addresses of the general user.  It will also strip <a href="https://en.wikipedia.org/wiki/Exif">image metadata</a> related to the author’s geographical location.  It also helps to verify that the original author uploaded the image they intended.</p>

<p>The ability to upload images on steemit.com was originally added in January, 2017.  Please note that this tool <strong>does not</strong> store any image data on the blockchain.</p>

<p>Detaied information on Imagehoster can be found in its <a href="https://gitlab.syncad.com/hive/imagehoster/-/blob/master/README.md#imagehoster">repository</a></p>

<h2 id="the-api">The API</h2>

<p>Below are examples of how to process images with the API</p>

<ol>
  <li><a href="#upload-image"><strong>Upload an image</strong></a></li>
  <li><a href="#fetch-upload"><strong>Fetch an uploaded image</strong></a></li>
  <li><a href="#proxy-resize"><strong>Proxy and resize an image</strong></a></li>
  <li><a href="#user-avatar"><strong>Get user avatar image</strong></a></li>
  <li><a href="#signing"><strong>Signing uploads</strong></a></li>
  <li><a href="#how-to-run"><strong>How to run</strong></a></li>
</ol>

<h4 id="1-upload-an-image-">1. Upload an image <a name="upload-image"></a></h4>

<p><code class="highlighter-rouge">POST /&lt;username&gt;/&lt;signature&gt;</code></p>

<p>This returns a JSON object container the URL to the uploaded image, ex:</p>

<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>{
    "url": "https://images.example.com/DQmZi174Xz96UrRVBMNRHb6A2FfU3z1HRPwPPQCgSMgdiUT/test.jpg"
}
</code></pre></div></div>

<p>For this to succeed it requires a signature from a Hive account in good standing.</p>

<h4 id="2-fetch-an-uploaded-image-">2. Fetch an uploaded image <a name="fetch-upload"></a></h4>

<p><code class="highlighter-rouge">GET /&lt;image_hash&gt;/&lt;filename&gt;</code></p>

<p>This downloads a previously uploaded image.</p>

<p><code class="highlighter-rouge">&lt;filename&gt;</code> is optional but can be provided to help users and applications understand the content type (Content-Type header will still always reflect actual image type)</p>

<h4 id="3-proxy-and-resize-an-image-">3. Proxy and resize an image <a name="proxy-resize"></a></h4>

<p><code class="highlighter-rouge">GET /&lt;width&gt;x&lt;hight&gt;/&lt;image_url&gt;</code></p>

<p>This downloads and serves the provided <code class="highlighter-rouge">image_url</code>. Something to note is that a copy will be taken of the image and will be served on subsequent requests, so even if the upstream is removed or changes, you will still get the original from the proxy endpoint.</p>

<p><code class="highlighter-rouge">&lt;width&gt;</code> and <code class="highlighter-rouge">&lt;height&gt;</code> can be set to <code class="highlighter-rouge">0</code> to preserve the image’s dimensions, if they are <code class="highlighter-rouge">&gt;0</code> the image will be aspect resized (down-sample only) to fit.</p>

<h4 id="4-get-user-avatar-image-">4. Get user avatar image <a name="user-avatar"></a></h4>

<p><code class="highlighter-rouge">GET /u/&lt;username&gt;/avatar/&lt;size&gt;</code></p>

<p>This presents the avatar for <code class="highlighter-rouge">username</code>. If no avatar is set, a default image will be served. This default is set in the service config.</p>

<p>The sizes are:</p>
<ul>
  <li>small - 64x64</li>
  <li>medium - 128x128</li>
  <li>large - 512x512</li>
</ul>

<p>The avatars follow the same sizing rules as proxied images, so you not guaranteed to get a square image, just an image fitting inside of the <code class="highlighter-rouge">size</code> square</p>

<h4 id="5-signing-uploads-">5. Signing uploads <a name="signing"></a></h4>

<p>Uploads also require a signature made by a Hive account’s posting authority. The account has to also be above a certain (service configurable) reputation threshold.</p>

<p>Creating a signature for <code class="highlighter-rouge">node.js</code> and with <code class="highlighter-rouge">dhive</code>:</p>

<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">const</span> <span class="nx">dhive</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="dl">'</span><span class="s1">dhive</span><span class="dl">'</span><span class="p">)</span>
<span class="kd">const</span> <span class="nx">crypto</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="dl">'</span><span class="s1">crypto</span><span class="dl">'</span><span class="p">)</span>
<span class="kd">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="dl">'</span><span class="s1">fs</span><span class="dl">'</span><span class="p">)</span>

<span class="kd">const</span> <span class="p">[</span><span class="nx">wif</span><span class="p">,</span> <span class="nx">file</span><span class="p">]</span> <span class="o">=</span> <span class="nx">process</span><span class="p">.</span><span class="nx">argv</span><span class="p">.</span><span class="nx">slice</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>

<span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nx">wif</span> <span class="o">||</span> <span class="o">!</span><span class="nx">file</span><span class="p">)</span> <span class="p">{</span>
    <span class="nx">process</span><span class="p">.</span><span class="nx">stderr</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="s2">`Usage: ./sign.js &lt;posting_wif&gt; &lt;file&gt;\n`</span><span class="p">)</span>
    <span class="nx">process</span><span class="p">.</span><span class="nx">exit</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
<span class="p">}</span>

<span class="kd">const</span> <span class="nx">data</span> <span class="o">=</span> <span class="nx">fs</span><span class="p">.</span><span class="nx">readFileSync</span><span class="p">(</span><span class="nx">file</span><span class="p">)</span>
<span class="kd">const</span> <span class="nx">key</span> <span class="o">=</span> <span class="nx">dhive</span><span class="p">.</span><span class="nx">PrivateKey</span><span class="p">.</span><span class="nx">fromString</span><span class="p">(</span><span class="nx">wif</span><span class="p">)</span>
<span class="kd">const</span> <span class="nx">imageHash</span> <span class="o">=</span> <span class="nx">crypto</span><span class="p">.</span><span class="nx">createHash</span><span class="p">(</span><span class="dl">'</span><span class="s1">sha256</span><span class="dl">'</span><span class="p">)</span>
    <span class="p">.</span><span class="nx">update</span><span class="p">(</span><span class="dl">'</span><span class="s1">ImageSigningChallenge</span><span class="dl">'</span><span class="p">)</span>
    <span class="p">.</span><span class="nx">update</span><span class="p">(</span><span class="nx">data</span><span class="p">)</span>
    <span class="p">.</span><span class="nx">digest</span><span class="p">()</span>

<span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="nx">key</span><span class="p">.</span><span class="nx">sign</span><span class="p">(</span><span class="nx">imageHash</span><span class="p">).</span><span class="nx">toString</span><span class="p">()</span> <span class="o">+</span> <span class="dl">'</span><span class="se">\n</span><span class="dl">'</span><span class="p">)</span>
</code></pre></div></div>

<h4 id="6-how-to-run-">6. How to run <a name="how-to-run"></a></h4>

<p>This imagehoster demo must be run through linux due to a dependency on the <code class="highlighter-rouge">make</code> commandline.
You will also require <code class="highlighter-rouge">node.js</code> and <code class="highlighter-rouge">yarn</code> to run</p>

<ul>
  <li>
    <p>git clone https://gitlab.syncad.com/hive/imagehoster</p>
  </li>
  <li>
    <p>Run <code class="highlighter-rouge">make devserver</code></p>
  </li>
</ul>

<p>This will pull in all dependencies and spin up a hot-reloading development server. From there the HTTP methods can be used to alter the image loaded from the &lt;./test&gt; module.</p>

<ul>
  <li>Run <code class="highlighter-rouge">make lint</code> to load the autolinter.</li>
  <li>Run <code class="highlighter-rouge">make test</code> to run the unit tests for the active functions.</li>
</ul>

<p>Default configuration variables are in &lt;./config/defailt.toml&gt; and can be overridden by environment variables as definded in &lt;./config/custom-enfironment-variables.toml&gt;</p>

<p>The load order for the config files are: env vars &gt; <code class="highlighter-rouge">config/$NODE_ENV.toml</code> &gt; <code class="highlighter-rouge">config/default.toml</code></p>

		</section>
	
		<section id="services-dhf" class="row services-dhf">
			<h3>
				<a id="services-dhf">
					DHF
					
				</a>
			</h3>
			

			<h4 id="intro">Intro</h4>

<p>The DHF (Decentralized Hive Fund) is an account on the Hive blockchain (currently <a href="https://hiveblocks.com/@steem.dao">@steem.dao</a>) that receives 10% of the <a href="/tutorials-recipes/understanding-configuration-values.html#HIVE_INFLATION_NARROWING_PERIOD">annual new supply</a>.  These funds are dedicated to Hive platform improvements.</p>

<p>Every day a portion of the HBD fund managed by the DHF is distributed to various proposals, depending on <strong>a)</strong> how much the proposal is asking for and <strong>b)</strong> how much approval the proposal has.</p>

<blockquote>
  <p>The DHF was a concept proposed by <a href="https://hiveblocks.com/@blocktrades">@blocktrades</a> to allow Hive users to publicly propose work they are willing to do in exchange for pay. Hive users can then vote on these proposals in almost the same way they vote for witnesses.  It uses stake-weighted votes, but voters can vote for as many proposals as they want.</p>
</blockquote>

<p><sup>See original announcement, when it was called “SPS” on Steem: <a href="https://hive.blog/steem/@steemitblog/hf21-sps-and-eip-explained">https://hive.blog/steem/@steemitblog/hf21-sps-and-eip-explained</a></sup></p>

<h4 id="tools">Tools</h4>

<ul>
  <li><a href="https://hivedao.com/">https://hivedao.com/</a> - Hive Proposals UI by <a href="https://hive.blog/@dmitrydao">@dmitrydao</a></li>
  <li><a href="https://peakd.com/proposals">https://peakd.com/proposals</a> - Hive Proposals UI by <a href="https://peakd.com/@peakd">@peakd</a></li>
  <li><a href="https://wallet.hive.blog/proposals">https://wallet.hive.blog/proposals</a> - Vote for your favorite Hive proposals without leaving the safety of wallet.hive.blog.
<!-- * [https://joticajulian.github.io/steemexplorer/#/proposals](https://joticajulian.github.io/steemexplorer/#/proposals) - Check who voted what. -->
<!-- * [https://steemit.com/@proposalalert](https://steemit.com/@proposalalert) - Follow this account to be notified of new proposals. --></li>
</ul>

<h4 id="api">API</h4>

<p>To access the proposal system by JSON-RPC request, see: <a href="/apidefinitions/#database_api.list_proposals"><code class="highlighter-rouge">database_api.list_proposals</code></a>.  Proposal creation by broadcast operation, see: <a href="/apidefinitions/#broadcast_ops_create_proposal"><code class="highlighter-rouge">create_proposal</code></a>.</p>

		</section>
	


</div>
<div class="footer">
  <a href="#">Back to top</a>
</div>
<script>
    document.getElementById("open-nav").addEventListener("click", function () {
        document.body.classList.toggle("nav-open");
    });
</script>
</body>
</html>


<script src="/js/adjust.js"></script>

